/* -*-c++-*- */
/* osgEarth - Geospatial SDK for OpenSceneGraph
 * Copyright 2020 Pelican Mapping
 * http://osgearth.org
 *
 * osgEarth is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>
 */
#ifndef OSGEARTH_UTIL_LATLONG_FORMATTER_H
#define OSGEARTH_UTIL_LATLONG_FORMATTER_H

#include <osgEarth/Formatter>
#include <osgEarth/StringUtils>
#include <osgEarth/Units>

namespace osgEarth { namespace Util
{
    /**
     * Formats geodetic (latitude/longitude) coordinates.
     */
    class OSGEARTH_EXPORT LatLongFormatter : public Formatter
    {
    public:
        /** Output format for angles. */
        enum AngularFormat {
            FORMAT_DEFAULT,
            FORMAT_DECIMAL_DEGREES,
            FORMAT_DEGREES_DECIMAL_MINUTES,
            FORMAT_DEGREES_MINUTES_SECONDS,
            FORMAT_DEGREES_MINUTES_SECONDS_TERSE // Display degrees minutes seconds but don't display values that are 0 and don't show fractional values.
        };

        /** Formatting options. */
        enum Options {
            USE_SYMBOLS     = 1 << 0,   // whether to use symbols
            USE_COLONS      = 1 << 1,   // whether to separate components with colons
            USE_SPACES      = 1 << 2,   // whether to separate components with spaces
            USE_PREFIXES    = 1 << 3,   // whether to use E/W/N/S prefixes
            USE_SUFFIXES    = 1 << 4,   // whether to use E/W/N/S suffixes
        };

    public:
        /**
         * Constructs a lat-long formatter.
         */
        LatLongFormatter(          
            const AngularFormat& defaultFormat =FORMAT_DECIMAL_DEGREES,
            unsigned             optionsMask   =0u );

        /** dtor */
        virtual ~LatLongFormatter() { }

        /**
         * Sets the output precision for decimal numbers  (default is 5)
         */
        void setPrecision( int value ) { _prec = value; }

        /**
         * Sets the formatting options
         */
        void setOptions( const Options& options ) { _options = options; }

        /** 
         * Formats an angle into one of the supported angular formats
         */
        std::string format(
            const Angular&       angle,
            bool                 latitude,
            int                  precision    =-1, 
            const AngularFormat& outputFormat =FORMAT_DEFAULT) const;

        /**
         * Parses a string into an angle (returning false if parsing fails).
         */
        bool parseAngle( const std::string& input, Angular& out_value );

    public: // Formatter

        virtual std::string format( const GeoPoint& p ) const;


    protected:
        unsigned      _options;
        AngularFormat _defaultFormat;
        int           _prec;
    };

} }

#endif // OSGEARTH_UTIL_LATLONG_FORMATTER_H
